package com.rede.didiok.admin.service;

import java.util.Collection;
import java.util.List;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;
import com.rede.didiok.admin.entity.AdminEntity;
import com.rede.didiok.common.dto.admin.AdminDto;

/**
 * 管理员表
 *
 * @author Rede
 * @email didiok@foxmail.com
 * @date 2023-08-07 18:21:17
 */
public interface AdminService extends IService<AdminEntity> {

    /***************************** didiok-admin:start **************************/
    // region  didiok-admin

    /**
     * 获取管理员列表
     *
     * @param adminDto
     * @return
     */
    IPage<AdminEntity> getList(AdminDto adminDto);

    /**
     * 重置密码
     *
     * @param adminDto
     * @return
     */
    String resetPwd(AdminDto adminDto);

    /**
     * 添加管理员
     *
     * @param adminDto
     * @return
     */
    String addAdmin(AdminDto adminDto);

    /**
     * 编辑管理员
     *
     * @param adminDto
     * @return
     */
    String editAdmin(AdminDto adminDto);

    /**
     * 批量删除管理员
     *
     * @param adminUids
     * @return
     */
    String deleteBatchAdmin(List<String> adminUids);

    /**
     * 获取在线用户列表
     *
     * @param adminDto
     * @return
     */
    String getOnlineAdminList(AdminDto adminDto);

    /**
     * 退出登录
     *
     * @param tokenList
     * @return
     */
    String forceLogout(List<String> tokenList);

    /**
     * 添加在线用户
     *
     * @param admin            管理员
     * @param expirationSecond 过期时间【秒】
     */
    void addOnlineAdmin(AdminEntity admin, Long expirationSecond);

    /**
     * 获取当前管理员
     *
     * @return
     */
    AdminEntity getMe();

    /**
     * 编辑当前管理员信息
     *
     * @return
     */
    String editMe(AdminDto adminDto);

    /**
     * 修改密码
     *
     * @return
     */
    String changePwd(String oldPwd, String newPwd);

    // endregion
    /***************************** didiok-admin:end **************************/

    /***************************** didiok-web:start **************************/
    // region didiok-web

    /**
     * Web端通过用户名获取一个Admin
     *
     * @param userName
     * @return
     */
    AdminEntity getAdminByUser(String userName);

    /**
     * 根据 userUid 查询绑定的管理员账号数量
     */
    Integer countAdminByUserUid(String userUid);

    /**
     * 通过 id 更新管理员密码
     * @param adminUid
     * @param password
     * @return
     */
    Boolean updateAdminPasswordById(String adminUid, String password);

    /**
     * 通过UIDs获取Admin
     *
     * @param uidList
     * @return
     */
    List<AdminEntity> getAdminListByUids(Collection<String> uidList);

    // endregion
    /***************************** didiok-web:end **************************/


    /**
     * 获取指定状态的管理员
     * @param status
     * @return
     */
    List<AdminEntity> listAdminByStatus(Integer status);

    /**
     * 通过UIDs获取Admin
     *
     * @param uidList
     * @return
     */
    AdminEntity getAdminByUid(String uid);

    /**
     * 通过UIDs获取Admin(不包括 photoUrl)
     *
     * @param uidList
     * @return
     */
    List<AdminEntity> getUserListWithoutAvatarByIds(Collection<String> uidList);

    /**
     * 通过 id 获取管理员昵称
     * @return
     */
    String getNicknameById(String uid);

}

